Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Media Functions / Text Media Handler Functions

FindNextText

The FindNextText function searches for text with a specified media handler starting at a given time.

pascal ComponentResult FindNextText (MediaHandler mh,
                                    Ptr text, long size, 
                                    short findFlags, 
                                    TimeValue startTime,
                                    TimeValue *foundTime,
                                    TimeValue *foundDuration,
                                    long *offset);

mh

Specifies the media handler for the text media obtained by the GetMediaHandler function.

text

Points to the text to be found.

size

Specifies the length of the text to be found.

findFlags

Specifies the conditions of the search. The following flags are available:

findTextEdgeOK

Finds sample at the given start time.

findTextCaseSensitive

Conducts a case-sensitive search for the text.

findTextReverseSearch

Searches backward for the text.

findTextUseOffset

Searches beginning from the value pointed to by the offset parameter.

findTextWrapAround

Conducts a wraparound search when the end or the beginning of the text is reached.

startTime

Indicates the time (expressed in the movie time scale) at which to begin the search.

foundTime

Contains a pointer to the movie time at which the text sample is found if the search is successful. Otherwise, it returns -1.

foundDuration

Contains a pointer to the duration of the sample (in the movie time scale) that is found if the search is successful.

offset

Contains a pointer to the offset of the found text from the beginning of the text portion of the sample.

DESCRIPTION

If the text sample is found, FindNextText returns the movie time at which it was located, the duration of the text sample, and its offset from the beginning of the text portion of the media sample.

ERROR CODES

invalidMedia

-2008

This media is corrupted or invalid

File Manager errors
Memory Manager errors